home *** CD-ROM | disk | FTP | other *** search
- /*
- ***************************************************************************
- * This file comprises part of PDCurses. PDCurses is Public Domain software.
- * You may use this code for whatever purposes you desire. This software
- * is provided AS IS with NO WARRANTY whatsoever.
- * Should this software be used in another application, an acknowledgement
- * that PDCurses code is used would be appreciated, but is not mandatory.
- *
- * Any changes which you make to this software which may improve or enhance
- * it, should be forwarded to the current maintainer for the benefit of
- * other users.
- *
- * The only restriction placed on this code is that no distribution of
- * modified PDCurses code be made under the PDCurses name, by anyone
- * other than the current maintainer.
- *
- * See the file maintain.er for details of the current maintainer.
- ***************************************************************************
- */
- #include <stdarg.h>
- #include <string.h>
- #define CURSES_LIBRARY 1
- #include <curses.h>
-
- /* undefine any macros for functions defined in this module */
- #undef scanw
- #undef wscanw
- #undef mvscanw
- #undef mvwscanw
- #undef vwscanw
-
- /* undefine any macros for functions called by this module if in debug mode */
- #ifdef PDCDEBUG
- # undef wgetstr
- # undef wrefresh
- # undef wmove
- #endif
-
- #ifdef PDCDEBUG
- char *rcsid_scanw = "$Id$";
- #endif
-
- /*man-start*********************************************************************
-
- Name: scanw
-
- Synopsis:
- int scanw(char *fmt, ...);
- int wscanw(WINDOW *win, char *fmt, ...);
- int mvscanw(int y, int x, char *fmt, ...);
- int mvwscanw(WINDOW *win, int y, int x, char *fmt,...);
- *** int vwscanw(WINDOW *win, char *fmt, va_list varglist);
-
- X/Open Description:
- These routines correspond to scanf(). The function scanw() reads
- input from the default window. The function wscanw() reads
- input from the specified window. The function mvscanw() moves
- the cursor to the specified position and then reads input from
- the default window. The function mvwscanw() moves the cursor to
- the specified position and then reads input from the specified
- window.
-
- For all the functions, the routine wgetstr() is called to get a
- string from the window, and the resulting line is used as
- input for the scan. All character interpretation is carried
- out according to the scanf function rules.
-
- PDCurses Description:
- The old Bjorn Larssen code for the 68K platform has been removed
- from this module.
-
- X/Open Return Value:
- Upon successful completion, the scanw, mvscanw, mvwscanw and
- wscanw functions return the number of items successfully
- matched. On end-of-file, they return EOF. Otherwise they
- return ERR.
-
- X/Open Errors:
- No errors are defined for this function.
-
- Portability X/Open BSD SYS V
- Dec '88
- scanw Y Y Y
- wscanw Y Y Y
- mvscanw Y Y Y
- mvwscanw Y Y Y
- vwscanw - - 4.0
-
- **man-end**********************************************************************/
-
- /***********************************************************************/
- int scanw(char *fmt, ...)
- /***********************************************************************/
- {
- va_list args;
- int retval = ERR;
-
- #ifdef PDCDEBUG
- if (trace_on) PDC_debug("scanw() - called\n");
- #endif
-
- #if !defined (HC)
- if (stdscr == (WINDOW *)NULL)
- return( retval );
-
- wrefresh(stdscr); /* set cursor position */
-
- /*
- * get string
- */
- c_printscanbuf[0] = '\0'; /* reset to empty string */
- if (wgetstr(stdscr, c_printscanbuf) == ERR)
- return( retval );
- va_start(args, fmt);
- #ifdef NO_VSSCANF
- retval = PDC_vsscanf(c_printscanbuf, fmt, args);
- #else
- retval = vsscanf(c_printscanbuf, fmt, args);
- #endif
- va_end(args);
- #endif
- return( retval );
- }
- /***********************************************************************/
- int wscanw(WINDOW *win, char *fmt, ...)
- /***********************************************************************/
- {
- va_list args;
- int retval = ERR;
-
- #ifdef PDCDEBUG
- if (trace_on) PDC_debug("wscanw() - called\n");
- #endif
-
- #if !defined (HC)
- if (win == (WINDOW *)NULL)
- return (retval);
-
- wrefresh(win); /* set cursor position */
-
- /*
- * get string
- */
- c_printscanbuf[0] = '\0'; /* reset to empty string */
- if (wgetstr(win, c_printscanbuf) == ERR)
- return( retval );
- va_start(args, fmt);
- #ifdef NO_VSSCANF
- retval = PDC_vsscanf(c_printscanbuf, fmt, args);
- #else
- retval = vsscanf(c_printscanbuf, fmt, args);
- #endif
- va_end(args);
- #endif
- return( retval );
- }
- /***********************************************************************/
- int mvscanw(int y, int x, char *fmt, ... )
- /***********************************************************************/
- {
- va_list args;
- int retval = ERR;
-
- #ifdef PDCDEBUG
- if (trace_on) PDC_debug("mvscanw() - called\n");
- #endif
-
- #if !defined (HC)
- if (stdscr == (WINDOW *)NULL)
- return( retval );
-
- if (wmove(stdscr, y, x) == ERR)
- return( retval );
-
- wrefresh(stdscr); /* set cursor position */
-
- /*
- * get string
- */
- c_printscanbuf[0] = '\0'; /* reset to empty string */
- if (wgetstr(stdscr, c_printscanbuf) == ERR)
- return( retval );
- va_start(args, fmt);
- #ifdef NO_VSSCANF
- retval = PDC_vsscanf(c_printscanbuf, fmt, args);
- #else
- retval = vsscanf(c_printscanbuf, fmt, args);
- #endif
- va_end(args);
- #endif
- return( retval );
- }
- /***********************************************************************/
- int mvwscanw(WINDOW *win, int y, int x, char *fmt,...)
- /***********************************************************************/
- {
- va_list args;
- int retval = ERR;
-
- #ifdef PDCDEBUG
- if (trace_on) PDC_debug("mvscanw() - called\n");
- #endif
-
- #if !defined (HC)
- if (win == (WINDOW *)NULL)
- return( retval );
-
- if (wmove(win, y, x) == ERR)
- return( retval );
-
- wrefresh(win); /* set cursor position */
-
- /*
- * get string
- */
- c_printscanbuf[0] = '\0'; /* reset to empty string */
- if (wgetstr(win, c_printscanbuf) == ERR)
- return( retval );
- va_start(args, fmt);
- #ifdef NO_VSSCANF
- retval = PDC_vsscanf(c_printscanbuf, fmt, args);
- #else
- retval = vsscanf(c_printscanbuf, fmt, args);
- #endif
- va_end(args);
- #endif
- return( retval );
- }
-